/*
 * @Author: 0x9DEFA478
 * @Date: 2021-09-20 17:00:00
 * @LastEditTime: 2021-12-17 23:09:03
 * @LastEditors: 0x9DEFA478
 * @Description: 
 * QQ:2652450237
 * ============================================================================================================================================
 * 
 * 
 * 
 *                                                                                               ************      ****************************
 *                                                                                             ************      ****************************  
 *                                                                                           ************      ****************************    
 *                                                                                         ************      ****************************      
 *                                                                                       ************      ************                        
 *                                                                                     ************      ************                          
 *                                                                                   ************      ************                            
 *                                                                                 ************      ************                              
 *                                                                               ************      ************                                
 *                                                                             ************      ************                                  
 *                                                                           ************      ************                                    
 *                                                                         ************      ************                                      
 *                                                                       ************      ************                                        
 *                                                                     ************      ************                                          
 *                                                                   ************      ************                                            
 *                                                                 ************      ************                                              
 *                                                               ************      ************                                                
 *                                                             ************      ************                                                  
 *                                                           ************      ************                                                    
 *                                                         ************      ************                                                      
 *                                                       ************      ************                                                        
 *                                                     ************      ************                                                          
 *                                                   ************      ************                                                            
 *                                                 ************      ************                                                              
 *                                               ************      ************                                                                
 *                                             ************      ************                                                                  
 *                                           ************      ************                                                                    
 *                                         ************      ************                                                                      
 *                                       ************      ************                                                                        
 *                                     ************      ************                                                                          
 *                                   ************      ************                                                                            
 *                                 ************      ************                                                                              
 *                               ************      ************                                                                                
 *                             ************      ************                                                                                  
 *                           ************      ************                                                                                    
 *                         ************      ************                                                                                      
 *       ****************************      ************                                                                                        
 *     ****************************      ************                                                                                          
 *   ****************************      ************                                                                                            
 * ****************************      ************                                                                                              
 * 
 * 
 * 
 * ============================================================================================================================================
 * 
 */
#ifndef __IP_I2C_H_
#define __IP_I2C_H_
#include "i2c.h"
#include "IP_DMA.h"


#define vIP_I2C_Error_None                0
#define vIP_I2C_Error_NAK                -1
#define vIP_I2C_Error_BusError           -2
#define vIP_I2C_Error_ArbitrationLost    -3
#define vIP_I2C_Error_Over               -4
#define vIP_I2C_Error_Unknow             -5

//获取发送dma实例
#define cIP_I2C_txDMA(ip_i2c) ((ip_i2c)->Instance.DMA_Tx->Instance.Instance)

//获取接收dma实例
#define cIP_I2C_rxDMA(ip_i2c) ((ip_i2c)->Instance.DMA_Rx->Instance.Instance)

//获取i2c实例
#define cIP_I2C_I2C(ip_i2c)   ((ip_i2c)->Instance.Instance)


typedef struct{
  struct{
    I2C_TypeDef* Instance;
    IP_DMA* DMA_Tx;
    IP_DMA* DMA_Rx;
  }Instance;

  void* volatile TransDoneCallback;
  void* volatile v_TransDoneCallback;

  struct{
    volatile int IsBusy;
    volatile int Error;//错误类型
    volatile int TxRemainingSize;
    volatile int TxIsStartTransfer;
    volatile int RxRemainingSize;
    volatile int RxIsStartTransfer;
    volatile unsigned int Addr;
  }TransStatus;

  
}IP_I2C;



/**
 * @brief 重初始化I2C 初始化为主机模式
 * @param ip_i2c 空的IP_I2C句柄(已分配内存的)
 * @param DMA_Tx 空的dma对象(已分配内存的 如果不使用可为NULL)
 * @param DMA_Rx 空的dma对象(已分配内存的 如果不使用可为NULL)
 * @param _i2c i2c句柄
 * @return 无
 */
void IP_I2C_MasterInit(IP_I2C* ip_i2c,IP_DMA* DMA_Tx,IP_DMA* DMA_Rx,I2C_TypeDef* _i2c);







/**
 * @brief 事件中断回调
 * @param ip_i2c IP_I2C句柄
 * @return 无
 */
void IP_I2C_EventIrqCallback(IP_I2C* ip_i2c);

/**
 * @brief 错误中断回调
 * @param ip_i2c IP_I2C句柄
 * @return 无
 */
void IP_I2C_ErrorIrqCallback(IP_I2C* ip_i2c);

/**
 * @brief 中断回调 此方法为中断回调不能与IP_I2C_ErrorIrqCallback()或IP_I2C_EventIrqCallback()同时使用
 * @param ip_i2c IP_I2C句柄
 * @return 无
 */
void IP_I2C_IrqCallback(IP_I2C* ip_i2c);

/**
 * @brief 设置传输完成回调
 * @param ip_i2c IP_I2C对象
 * @param Callback 回调函数
 * @param v 回调函数传入的参数
 * @return 0:成功 其他:失败
 */
int IP_I2C_SetTransDoneCallback(IP_I2C* ip_i2c,void (*Callback)(void*),void* v);

/**
 * @brief 进行I2C传输 在空闲时调用
 * @param ip_i2c IP_I2C句柄
 * @param Addr 目标地址 地址+读写位 读写位决定是否有读取 当最低位为1时 读取有效
 * @param TxData 发送的数据
 * @param TxLength 发送长度
 * @param RxData 如果读取数据 此段指向容纳读取数据的内存
 * @param RxLength 读取长度
 * @return 无
 */
void IP_I2C_MasterTransfer(IP_I2C* ip_i2c,unsigned char Addr,unsigned char* TxData,int TxLength,unsigned char* RxData,int RxLength);




#endif //__IP_I2C_H_
